home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / charstr.z / charstr
Text File  |  1998-10-20  |  5KB  |  148 lines
  1.  
  2.  
  3.  
  4. cccchhhhaaaarrrrssssttttrrrr((((3333GGGG))))                                                        cccchhhhaaaarrrrssssttttrrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cccchhhhaaaarrrrssssttttrrrr,,,, llllcccchhhhaaaarrrrssssttttrrrr - draws a string of characters
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd cccchhhhaaaarrrrssssttttrrrr((((SSSSttttrrrriiiinnnngggg ssssttttrrrr))))
  13.  
  14.      vvvvooooiiiidddd llllcccchhhhaaaarrrrssssttttrrrr((((ttttyyyyppppeeee,,,,ssssttttrrrr))))
  15.      lllloooonnnngggg ttttyyyyppppeeee;;;;
  16.      vvvvooooiiiidddd ****ssssttttrrrr;;;;
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _s_t_r      expects a pointer to the memory containing a sequence of
  20.               character id's.
  21.  
  22.      _t_y_p_e     expects one of the following symbolic constants defined in
  23.               <_g_l/_g_l._h>:
  24.  
  25.                           Each character id is represented
  26.                           by a single unsigned byte.
  27.                STR_B
  28.  
  29.                           Each character id is represented
  30.                           by two, consecutive unsigned
  31.                           bytes.
  32.                STR_2B
  33.  
  34.  
  35.                           Each character id is represented
  36.                           by three, consecutive unsigned
  37.                           bytes.
  38.                STR_3B
  39.  
  40.  
  41.                           Each character id is represented
  42.                           by four, consecutive unsigned
  43.                           bytes.
  44.                STR_4B
  45.  
  46.  
  47.                           Each character id is represented
  48.                           by a 16-bit unsigned integer.
  49.                STR_16
  50.  
  51.                           Each character id is represented
  52.                           by a 32-bit unsigned integer.
  53.                STR_32
  54.  
  55.  
  56. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  57.      cccchhhhaaaarrrrssssttttrrrr and llllcccchhhhaaaarrrrssssttttrrrr draw a string of text using the current raster font,
  58.      color and writemask.  The first character in the string is drawn at the
  59.      current character position.  After each character is drawn, the
  60.      character's x-pixel spacing value is added to the x-coordinate of the
  61.      current character position, and if defined using ddddeeeeffffllllffffoooonnnntttt, the
  62.      character's y-pixel spacing value is added to the y-coordinate.
  63.  
  64.      For strings displayed with llllcccchhhhaaaarrrrssssttttrrrr sequences of character id's are
  65.      converted to character values using the following formulas for the _i-th
  66.      character in unsigned byte-string _s:
  67.  
  68.        STR_B      _s[_i]
  69.        STR_2B     (_s[2*_i]*256) + _s[2*_i+1]
  70.        STR_3B     ((_s[3*_i]*256) + _s[3*_i+1])*256 + _s[3*_i+2]
  71.        STR_4B     (((_s[4*_i]*256) + _s[4*_i+1])*256) + _s[4*_i+2])*256 + _s[4*_i+3]
  72.  
  73.      For types SSSSTTTTRRRR____11116666 and SSSSTTTTRRRR____33332222, integer character id's correspond directly
  74.      to character values.
  75.  
  76.  
  77.  
  78.                                                                         PPPPaaaaggggeeee 1111
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85. cccchhhhaaaarrrrssssttttrrrr((((3333GGGG))))                                                        cccchhhhaaaarrrrssssttttrrrr((((3333GGGG))))
  86.  
  87.  
  88.  
  89.      The call cccchhhhaaaarrrrssssttttrrrr((((ssssttttrrrr)))) is equivalent in all cases to the call
  90.      llllcccchhhhaaaarrrrssssttttrrrr((((SSSSTTTTRRRR____BBBB,,,,ssssttttrrrr)))).   cccchhhhaaaarrrrssssttttrrrr and llllcccchhhhaaaarrrrssssttttrrrr may be used with raster fonts
  91.      defined by either ddddeeeeffffrrrraaaasssstttteeeerrrrffffoooonnnntttt or ddddeeeeffffllllffffoooonnnntttt.
  92.  
  93.  
  94.      End of string is indicated by a character id with a character value of
  95.      zero.    Characters not defined in the current raster font are ignored.
  96.  
  97.  
  98. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  99.      cmov, charstr, deflfont, defrasterfont, font, lstrwidth, strwidth,
  100.      getcpos
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.                                                                         PPPPaaaaggggeeee 2222
  145.  
  146.  
  147.  
  148.